Release 10.1A: OpenEdge Development:
ADM Reference

InvokeCall procedure

Procedure used to invoke a call.

Parameters:

pcProc INPUT CHARACTER

Name of the external or internal procedure, or function to be invoked.

phInHandle INPUT HANDLE

If pcProc is an internal procedure or function, this is the handle to the running persistent procedure that contains pcProc.

This parameter is optional. If nothing is specified, then ? is passed.

piType INPUT INTEGER

Type of call being invoked. Must be either PROCEDURE-CALL-TYPE or FUNCTION-CALL-TYPE. These are constants that are recognized by the 4GL compiler.

phParamTable INPUT HANDLE

Handle to a temp-table previously created by a call to one of the setupTTFrom functions.

This parameter is optional. If nothing is specified, then ? is passed.

plPersistent INPUT LOGICAL

Indicates whether the external procedure specified in pcProc should be invoked persistently.

phServer INPUT HANDLE

Handle to the AppServer where the call is to run.

This parameter is optional. If nothing is specified, then ? is passed.

plAsynch INPUT LOGICAL

If set to Yes, the call is invoked asynchronously.

pcEventProc INPUT CHARACTER

Applies only if plAsynch is set to Yes. This parameter identifies the procedure to be invoked when the asynchronous call completes.

This parameter is optional. If nothing is specified, then "" is passed.

phEventProcCtxte INPUT HANDLE

Contains the handle of the procedure that contains pcEventProc.

This parameter is optional. If nothing is specified, then ? is passed.

piCal OUTPUT INTEGER

Unique identifier to the ttCall record that is created for this call. You can use this call number until cleanupCall is run to call either obtainCallInfo or cleanupCall.

Notes:

By default, all three handles are deleted when cleanupCall is invoked. To have all handles except the Call Handle deleted, pass "!H".
By default, the function appends an "*" to the end of the string. As a result, all handles other than those explicitly specified are cleaned up.